home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 3 / Gold Medal Software - Volume 3 (Gold Medal) (1994).iso / wordproc / wf_v31c.arj / DOCS / WF.016 < prev    next >
Text File  |  1992-01-31  |  61KB  |  1,385 lines

  1. .f3                              - # -        Chapter 16 - Printing & Formatting
  2. .rm70
  3. .tc
  4. .tc1
  5. .tc 16. PRINTING & FORMATTING .............................#
  6. CHAPTER 16   PRINTING & FORMATTING
  7.  
  8. .imFooters
  9. .imHeaders
  10. .IMPrinting
  11. Word Fugue uses several methods to format text:
  12. ■  Dot lines. These are special text lines that control most
  13.    formatting features.
  14. ■  Editing commands, including special font characters.
  15.  
  16. .tc    Printing a File ....................................#
  17. Printing a File
  18. .ix   Printing
  19. .ix   Background
  20. .ixPrint Formatting;Print Formatting
  21.  
  22. Any text file can be printed from within Word Fugue. Files formatted
  23. with Word Fugue's page layout commands and font controls will print
  24. with multiple fonts, headers, footers, and page breaks. Press Ctrl K
  25. P to initiate background printing. Once printing has started, you can
  26. continue with any editing.
  27.  
  28.  
  29.       ╔═══════════════════════════ Print Setup ═══════════════════════════╗
  30.       ║  Print file now                                                   ║
  31.       ╠═══════════════════════════════════════════════════════════════════╣
  32.       ║  Name of file       C:\WF\DOC\WF.016                              ║
  33.       ║  Auto formatting     ON                                           ║
  34.       ║  First page         1                                             ║
  35.       ║  Last page          4095                                          ║
  36.       ║  Odd or Even pages  Both                                          ║
  37.       ║  Copies             1                                             ║
  38.       ║  Quality of print   Letter Quality                                ║
  39.       ║  Text Offset        6                                             ║
  40.       ║  Initial line size  Normal = 6 lines per inch (.LH 10 / 60)       ║
  41.       ╠═══════════════════════════════════════════════════════════════════╣
  42.       ║  Which printer      C:\WF\NECP7.PDF                               ║
  43.       ║  Device             LPT1                                          ║
  44.       ║  Manual paper feed  OFF                                           ║
  45.       ║  Use formfeeds       ON                                           ║
  46.       ║  Edit printer codes                                               ║
  47.       ║  Save printer setup                                               ║
  48.       ╚═══════════════════════════════════════════════════════════════════╝
  49.  
  50.  
  51.                          Fig 16.1 - Print Menu
  52. .tc1 Fig 16.1 - Print Menu .................................#
  53.  
  54.  
  55. Do not press <Enter> on the first menu selection, Print file now,
  56. until the other items in the box have been set to your satisfaction.
  57. Selecting the first item starts the print job.
  58.  
  59. .ix   Name of File
  60. After you select the second menu item, Name of file, a prompt box will
  61. request entry of the name of the file to print. When prompted for a
  62. file name, you may enter DOS wildcards or the name of another drive or
  63. subdirectory. In this case, another window will display the names of
  64. all matching files. You can select from this list by using the cursor
  65. keypad, or by pressing the first letter of the filename in which you
  66. are interested.
  67.  
  68. .ix   Print file being edited
  69. If you wish to print a file that is currently loaded in memory, Word
  70. Fugue will ask you whether you want to save the file. If you answer
  71. Yes, the file will be saved, and printing will commence. If you answer
  72. NO then printing will not commence.
  73.  
  74. .CP5
  75. NOTE - You should be aware that if you start printing a file currently
  76.        in memory, and then make further changes to that file while it
  77.        is being printed, then those changes will not print, only the
  78.        saved copy on disk.
  79.  
  80.        If you attempt to save a file to disk when you are currently
  81.        printing it, you will probably receive a DOS error (depending on
  82.        your version of DOS) since the old version of the file will
  83.        still be open by the print routine when Word Fugue tries to
  84.        rename it or delete it (depending on your option for "Make
  85.        backup files").
  86.  
  87. .ix   Autoformatting
  88. Set Auto formatting OFF if you wish to have Word Fugue ignore
  89. formatting commands (. commands) in your text. In this case, text will
  90. print continuously with no form feeds or page breaks. Control codes
  91. embedded in the text will be written to the output without
  92. interpretation.
  93.  
  94. .ix   Printing
  95. .ixPrint Formatting;Print Formatting
  96. .ix   First Page
  97. .ix   Last Page
  98. .ix   Page Range
  99. .ix   Odd or Even pages only
  100. .ix   Even or Odd pages only
  101. By default, Word Fugue prints all pages of the document. You can set
  102. starting and stopping pages if desired, by use of First Page and Last
  103. Page. You can also determine to print only ODD or EVEN pages by use of
  104. Odd or Even Pages. This is very useful for printing on both sides of
  105. paper.
  106.  
  107. .ix   Number of copies
  108. The number of copies defaults to 1, but you can change it to any
  109. number between 1 and 20 by use of the Copies option.
  110.  
  111. .ix   Quality of Print
  112. .ixLetter Quality;Letter Quality Printing
  113. .irCorrespondence;Correspondence quality printing
  114. .irCorrespondencf;   See Letter Quality Printing
  115. The Quality of print defaults to Default, but you can change it to
  116. Letter Quality with this option.
  117.  
  118. .ix   Text Offset
  119. .irPage Offset;Page Offset see Text Offset
  120. .ixMargins             ;   Text Offset
  121. .ixMargins             ;   Page Offset
  122. This determines how far in from the left edge of the paper your text
  123. prints. The factory default is 6 characters, but this can be changed
  124. on this menu, and saved by using the Save Options menu option.
  125.  
  126. Select from any of the available printer definition files (default
  127. extension .PDF) to find one that is appropriate for your printer. You
  128. can change to another file and use Options Save setup to default
  129. subsequent use to that file.
  130.  
  131. .ix   Printer port
  132. .ix   Spooling to file
  133. You can also choose between sending the printed output to LPT1, LPT2,
  134. LPT3, COM1, COM2, PRN or to a file. LPTn & COMn refer to the computer
  135. port where your printer is attached. If the printer is attached to a
  136. serial port, you must use one of COM1 or COM2, while if it is attached
  137. to a parallel port you must use one of LPT1, LPT2 or LPT3. Your choice
  138. will be saved with Word Fugue when you Save Setup. PRN will print
  139. through the same port as LPT1, but is useful if you are printing over
  140. a network and find that nothing prints until you exit Word Fugue.
  141.  
  142. When output is printed to a file, all control codes are written out
  143. just as when they are printed. In this case, you must also specify the
  144. name of the output file using the prompt window.
  145.  
  146. .ix   Manual paper feed
  147. Set Manual paper feed ON if you wish to have Word Fugue prompt you to
  148. insert a new sheet of paper after each page. This choice is also
  149. stored as part of the printer definition file for your selected
  150. printer.
  151.  
  152. .CP4
  153. .ix   Formfeeds
  154. Set Use formfeeds ON if your printer accepts ASCII character #12 to
  155. eject each page. Otherwise, Word Fugue will fill out the end of each
  156. page with blank lines.
  157.  
  158. After making all selections, move the menu bar to the Print file now
  159. item and press <Enter>. If you decide not to print, just press <Esc>.
  160. Printing occurs as a background task. You can continue editing with
  161. minimal loss of performance while the print job continues.
  162.  
  163. To stop a print job at any time, execute the Print File command
  164. sequence. Word Fugue will confirm whether you want to stop the print
  165. job.
  166.  
  167. You can edit and store printer definitions from within Word Fugue,
  168. using the Edit Printer Codes and Save Printer codes of the File Print
  169. menu.
  170.  
  171. Select a printer definition file (default extension .PDF) using the
  172. Which printer menu item. Word Fugue will load this printer file into
  173. memory.
  174.  
  175. .ix   Printing
  176. .ixPrint Formatting;Print Formatting
  177. .tc      Editing Printer Sequences ........................#
  178. Editing Printer Sequences
  179. .ix   Edit printer control sequences
  180.  
  181. Select Edit Printer Codes on the print menu, and you will see a pick
  182. list of available print sequences:
  183.  
  184.  
  185.                 ╔═══════ Printer Strings ═══════╗
  186.                 ║  Initialization               ║
  187.                 ║  Reset                        ║
  188.                 ║  Bold text ^B  ON             ║
  189.                 ║  Bold text ^B OFF             ║
  190.                 ║  Doublestrike ^D  ON          ║
  191.                 ║  Doublestrike ^D OFF          ║
  192.                 ║  Underscore ^S  ON            ║
  193.                 ║  Underscore ^S OFF            ║
  194.                 ║  Superscript ^T  ON           ║
  195.                 ║  Superscript ^T OFF           ║
  196.                 ║  Subscript ^V  ON             ║
  197.                 ║  Subscript ^V OFF             ║
  198.                 ║  Compressed ^A  ON            ║
  199.                 ║  Compressed ^A OFF            ║
  200.                 ║  Italic ^Y  ON                ║
  201.                 ║  Italic ^Y OFF                ║
  202.                 ║  8 Lines Per Inch ^C          ║
  203.                 ║  6 Lines Per Inch ^C          ║
  204.                 ║  Paper Length in Inches ^E    ║
  205.                 ║  Paper Length in Inches ^E    ║
  206.                 ║  Paper Length in Lines ^F     ║
  207.                 ║  Paper Length in Lines ^F     ║
  208.                 ╚════════════════v│^│═════════════╝
  209.  
  210.  
  211.                      Fig 16.2 - Printer Sequence Edit Menu
  212. .tc1 Fig 16.2 - Printer Sequence Edit Menu .................#
  213.  
  214.  
  215. .CP5
  216. Use the cursor keys to highlight the sequence to edit, and press
  217. Enter.  When you choose a sequence to edit, its title appears in
  218. another window.
  219.  
  220.  
  221.                 ╔══════════Edit Esc seq name═══════════╗
  222.                 ║ Initialization                       ║
  223.                 ╚══════════════════════════════════════╝
  224.  
  225.  
  226.                          Fig 16.3 - Edit Print Sequence Title
  227. .tc1 Fig 16.3 - Edit Print Sequence Title ..................#
  228.  
  229.  
  230. You can accept it as is by pressing Enter, or change it and then press
  231. Enter. You should always include the activation letter in the name,
  232. for ease when replaying. The default titles stored in the printer
  233. definition files all have the control code as part of the title. If
  234. you make changes and forget what the activation control code is, you
  235. can edit the title, press Ctrl X to delete the contents, then press
  236. Enter. Word Fugue will replace the empty title by its stored default
  237. title, which will include the activation letter.
  238.  
  239. .ix   Printing
  240. .ixPrint Formatting;Print Formatting
  241. .ix   Edit printer control sequences
  242. Once you have pressed Enter on the printer sequence name, you will see
  243. the sequence itself in another pop up window.
  244.  
  245.  
  246.         ╔═════════════════ Initialization ══════════════════╗
  247.         ║ <Ctrl\>@<Esc>CF<Esc>M                             ║
  248.         ║                                                   ║
  249.         ║                                                   ║
  250.         ║                                                   ║
  251.         ║                                                   ║
  252.         ║                                                   ║
  253.         ║                                                   ║
  254.         ║                                                   ║
  255.         ║                                                   ║
  256.         ║                                                   ║
  257.         ║                                                   ║
  258.         ║                                                   ║
  259.         ║                                                   ║
  260.         ╚═══════════════════════════════════════ Command ═══╝
  261.  
  262.  
  263.                          Fig 16.4 - Edit Printer Sequence
  264. .tc1 Fig 16.4 - Edit Printer Sequence ......................#
  265.  
  266.  
  267. Most characters you type will be inserted literally into the printer
  268. control sequence, with the following exceptions.
  269.  
  270. It can be edited using the cursor arrow keys, and the <Del> or
  271. <Backspace> keys.  <CtrlBksp> will delete the entire sequence.
  272. <Enter> will end the editing of that sequence. <Esc> will undo any
  273. changes made to the sequence. Pressing Alt plus the number keys on the
  274. numeric keypad to code the decimal sequence of a character will enter
  275. that character. This makes it easy to enter those high order
  276. characters that do not appear on the keyboard. Consult your DOS manual
  277. for more information on entering alternate key strokes on your
  278. computer.
  279.  
  280. In case you need to enter any of these special keys as part of the
  281. sequence, press the <ScrollLock> key to enter Literal mode. In this mode,
  282. all keystrokes will be inserted into the macro without any
  283. interpretation. In order to terminate the edit when in this mode, you
  284. will need to press <ScrollLock> again in order to enter the <Enter> or
  285. <ESC> characters.
  286.  
  287. The printer definition currently held in memory can be stored to a
  288. disk file using the Save printer setup menu item. Word Fugue stores
  289. the printer command sequences for all fonts, as well as the default
  290. settings for manual paper feed and formfeeds, when you save the setup.
  291.  
  292. .CP6
  293. .ix   Printing
  294. .ixPrint Formatting;Print Formatting
  295. .ix   Edit printer control sequences
  296. Word Fugue will prompt for a file name when you decide to store the
  297. current definition. The default extension for printer definitions is
  298. .PDF. The name of the file you loaded will be shown as the default
  299. name under which to save. If you press enter, you will be asked
  300. whether to overwrite the existing file.
  301.  
  302.  
  303. .tc    Printer Format Commands.............................#
  304. Printer Format Commands
  305. .ix   Printer Format Commands
  306. .ir   Control Codes See Printer Format commands
  307.  
  308. Any of the command sequences that control various printer fonts can be
  309. edited using the Edit printer codes menu selection. Each font is
  310. associated with two strings - one to turn the font ON, and another to
  311. turn it OFF. The sequences are activated by control characters
  312. embedded in the text. These characters can be inserted either by the
  313. special font characters (look in help under Text Attributes) or by
  314. pressing the Control character insertion command (Ctrl K P) followed
  315. by the letter corresponding to the control character.
  316.  
  317. The exceptions to this rule about activation letters are:
  318.  
  319.    Initialization and Reset, which are sent at the beginning and end of
  320.    the print respectively, and Letter Quality and Default Quality,
  321.    which are sent at the start of each page.
  322.  
  323. These others are sent when a control character is encountered - the ON
  324. sequence is sent the first time, and the OFF sequence is sent the
  325. second time. (then back to ON ...)
  326.  
  327. .CP22
  328.    ^B On & Off    - usually bold            Alt B
  329.    ^D On & Off    - usually double strike   Alt D
  330.    ^S On & Off    - usually underline       Alt U
  331.    ^T On & Off    - usually superscript     Alt T
  332.    ^V On & Off    - usually subscript       Alt V
  333.    ^A On & Off    - usually compressed      Alt C
  334.    ^Y On & Off    - usually italics         Alt I
  335.    ^C On & Off                              Ctrl P C
  336.    ^E On & Off                              Ctrl P E
  337.    ^F On & Off                              Ctrl P F
  338.    ^G On & Off                              Ctrl P G
  339.    ^N On & Off                              Ctrl P N
  340.    ^P On & Off                              Ctrl P P
  341.    ^Q On & Off                              Ctrl P Q
  342.    ^R On & Off                              Ctrl P R
  343.    ^U On & Off                              Ctrl P U
  344.    ^W On & Off                              Ctrl P W
  345.    ^X On & Off                              Ctrl P X
  346.    ^\ On & Off                              Ctrl P \
  347.    ^^ On & Off                              Ctrl P ^
  348.    ^_ On & Off                              Ctrl P _
  349.    ^] On & Off                              Ctrl P ]
  350.  
  351. The linkage between the control character encountered in the text and
  352. the sequence used is positional as detailed above. Feel free to define
  353. your own meanings for these sequences, but we advise you to include
  354. the activation character and the words ON or OFF in the name, so that
  355. you do not forget what they are. Word Fugue predefines the names of
  356. each sequence, so should you delete the name of a sequence, word Fugue
  357. will show the predefined name.
  358.  
  359. .CP6
  360. .ix   Printing
  361. .ixPrint Formatting;Print Formatting
  362. .tc       Laser Printers and Dot Matrixes .................#
  363. Laser Printers and Dot Matrixes
  364. .ix   Laser printers
  365. .ix   Dot Matrix printers
  366.  
  367. There are 2 methods of print control:
  368.  
  369. 1.   The Epson model, where each attribute is independent. If you set
  370.      up bold, italic, underline in that order, turning off italic
  371.      still leaves bold & underline on. In this model, when the second
  372.      ^Y is encountered (Italics OFF), all that is required is to send
  373.      the stored OFF sequence.
  374.  
  375. 2.   The laser printer model, where each attribute selects a
  376.      particular font, and attributes are only turned off by selecting
  377.      a new font. Thus if you have bold, italic & underlined text, the
  378.      only way to turn off italics is to select text that is bold and
  379.      underlined. In this model, when the second ^Y is encountered
  380.      (Italics OFF), what is required is to send the on sequences of
  381.      all the other active fonts.
  382.  
  383. Some printers have a mixture of the 2 methods. (Laser printers are
  384. notorious for this with the sequence that controls underlining
  385. conforming to the Epson model). Word Fugue assumes that where a print
  386. control sequence is set up so that the sequence to turn it off is
  387. empty, then you need it to turn on all other ON fonts back on again.
  388. Note that this implies that Word Fugue has knowledge of the initial
  389. choice of fonts, so you should ensure that the Letter Quality and
  390. Default Quality sequences are set up for your printer. If the OFF
  391. sequence has values in it (beware of storing spaces in an OFF
  392. sequence, since this will fool Word Fugue into thinking that the
  393. sequence is present) then Word Fugue sends the OFF sequence only. {.╬}
  394. {.╬}
  395. .tc          Printable Area ...............................#
  396. Printable Area
  397. .ix   Printable Area
  398.  
  399. Dot Matrix printers and any other Line Printers can normally print
  400. over the entire page area. Laser printers and other Page Printers are
  401. normally restricted to an area smaller than the page size. {.╬}
  402. {.╬}
  403. For example, on normal US letter size paper there are 66 lines, and a
  404. dot matrix printer will be able to print on all of them. A typical
  405. laser printer on the other hand will only print 64 lines on the page.
  406. What happens to lines 65 & 66 depend upon your printer. Some will
  407. ignore the extra lines, while others will print them on another page.{.╬}
  408. {.╬}
  409. You need to be aware of this when paginating a document for a laser
  410. printer.{.╬}
  411. {.╬}
  412. .CP6
  413.   Printers that Ignore the Extra Lines{.╬}
  414. {.╬}
  415.   For these printers it is relatively simple - you need to set the
  416.   margin at the bottom of the document in such a way as to leave the
  417.   last 2 lines blank. The exact size will depend upon whether you want
  418.   to print 1, 2 or 3 footer lines. The examples below assume that you
  419.   want one line space between your text and the first footer line. If
  420.   you want more you should increase the value of the Bottom margin by
  421.   one for each extra blank line:{.╬}
  422.   {.╬}
  423.   3 Footer Lines{.╬}
  424.         Set the Bottom margin to 6  (.MB 6){.╬}
  425.         Set the Footer margin to 5  (.FM 5){.╬}
  426.   {.╬}
  427.   2 Footer Lines{.╬}
  428.         Set the Bottom margin to 5  (.MB 5){.╬}
  429.         Set the Footer margin to 4  (.FM 4){.╬}
  430.   {.╬}
  431.   1 Footer Line{.╬}
  432.         Set the Bottom margin to 4  (.MB 4){.╬}
  433.         Set the Footer margin to 3  (.FM 3){.╬}
  434.   {.╬}
  435.   If you are not sure about your printer, try this option first. If
  436.   you find yourself receiving a blank page after every printed page,
  437.   you need to read below.{.╬}
  438.   {.╬}
  439.   Printers that Print the Extra Lines on a New Page{.╬}
  440. {.╬}
  441.   For these printers it is more complicated - you need to set the page
  442.   size to something larger than the number of lines you actually want
  443.   to print. Page printers do have commands for both the page size and
  444.   the printable area size, so this can be done from a PDF.{.╬}
  445.   {.╬}
  446.   If you are working with normal US Letter size (66 lines long), or
  447.   Metric A4 (70 lines long) but you only want 66 lines per page, you
  448.   could use the initialise print sequence to set the page size to A4
  449.   (= 70 lines) and then format for 66 lines. The page size command in
  450.   your PDF should actually contain the command for the size of the
  451.   Printable Area, and can either set it to 66 lines, or contain a $ or
  452.   # character to permit Word Fugue to set the size itself.{.╬}
  453.  
  454.   For example:
  455.  
  456.         Using HP Laserjet sequences
  457.  
  458.         Your PDF:
  459.  
  460.         Initialise      =  <ESC>E<ESC>&l26a70p66F
  461.  
  462.         Page Length     =  <ESC>&L70p$F
  463.  
  464.  
  465.         Your Text:
  466.  
  467.         .PL66
  468.  
  469.  {.╬}
  470.   However, if you use A4 normally, and you wish to print 70 lines per
  471.   page instead of 66 lines per page, you need to set the page size to
  472.   something larger, such as 72 or 74 lines. This could cause your
  473.   printer to demand you to "Load Legal size paper" or similar, which
  474.   will then have to be over-ridden from the control panel.{.╬}
  475.   {.╬}
  476.   The file LASERJET.PDF is an example of this for use with printers
  477.   that employ HP Laserjet emulations. It sets the page size to 72
  478.   lines, and allows Word Fugue to set the printable area to either 66
  479.   lines or 70 lines, depending on which you prefer.{.╬}
  480. {.╬}
  481. .tc       On Screen Display of Fonts ......................#
  482. On Screen Display of Fonts
  483. .ixDisplaying;   Printer fonts
  484. .ixDisplaying;Displaying
  485.  
  486. If font display is on, the text will appear in the colour you have
  487. selected for that font. If font display is off, the codes will appear
  488. as alphabetic letters but in a different colour from the text.
  489.  
  490. .tc    Colour Ribbons .....................................#
  491. Colour Ribbons
  492. .ixColours;   of Print Ribbons
  493.  
  494. Some printers allow the use of colour ribbons. You can switch to a
  495. different colour by inserting the appropriate control code into your
  496. text. Word Fugue assumes that you start with a black ribbon, so the
  497. first time you enter a colour control code, you will switch to that
  498. colour. The second time you enter the same control code, you will
  499. switch back to black. If you enter a different code, you will switch
  500. to that colour.
  501.  
  502. The control codes that we have reserved for colours are:
  503.  
  504.     Ctrl P Q    -    Blue
  505.     Ctrl P R    -    Green
  506.     Ctrl P U    -    Red
  507.     Ctrl P ^    -    Violet
  508.     Ctrl P _    -    Yellow
  509.     Ctrl P ]    -    Magenta
  510.  
  511. If you have a colour printer, check that your Printer Definition File
  512. (PDF) has these codes set up. If not, you can easily set these up.
  513.  
  514. .CP5
  515. .ixTIPS;   Printing in colour
  516. TIP - Install the code for black as part of the "Default Quality" and
  517.       "Letter Quality" sequences, since these are sent whenever you
  518.       turn off a sequence and the off sequence is empty.
  519.  
  520.       If you change from one colour to another, you should first turn
  521.       off the original colour.
  522.  
  523. For example this text is black ^Qwhile this text is blue^Q^Rand this
  524. is green^R
  525.  
  526. .tc    Dot Commands .......................................#
  527. Dot Commands
  528.  
  529. Dot commands perform a variety of functions, mostly related to
  530. printing. They are also used for table of contents and indexing. Type
  531. a period (dot) in column 1 and follow it with a 2 character command
  532. code and any other information that the command code requires. It does
  533. not matter whether the commands are in upper case or lower case. Press
  534. enter to end the line. The line remains in your file, but does not
  535. appear in the printout.
  536.  
  537. If you require, the prefix character (dot or period) can be changed to
  538. another  character. From the pull down menu, select Options, followed
  539. by Global file options, and then Print format character. You will be
  540. prompted for the new character to use. This character can be any
  541. special character (ie non numeric and non alphabetic). The new
  542. character can be saved so that Word Fugue will always use the
  543. character you have specified. If you do change the character, it will
  544. be used for all printing from that time forth. IE, you cannot change
  545. prefix in mid document. This option is useful if you are switching
  546. between documents produced under Borland's Sprint, which uses Wordstar
  547. compatible "dot" commands, but prefixes them with an @ character.
  548. Alternatively, you may be one of those who wants to type dots in
  549. column one and have them print.
  550.  
  551. .cp15
  552. .ix   Printing
  553. .ixPrint Formatting;Print Formatting
  554. .tc      Print formatting Dot Commands.....................#
  555. Print Formatting Dot Commands
  556.  
  557. Those commands specific to Mail Merge are discussed in chapter 17,
  558. those commands for Table of Contents are discussed in chapter14,
  559. while those for indexing are discussed in chapter 15. Dot commands
  560. always start in column one with a dot (.), which is why they are
  561. referred to as Dot Commands.
  562.  
  563. The prefix character can be changed from a dot to some other
  564. character, if you have changed the prefix character, use the
  565. appropriate prefix in place of the dot. The next 2 characters specify
  566. the command. They can be in uppercase or lower case, but they must
  567. follow immediately after the dot in columns 2 and 3. Other parameters
  568. may follow after these characters. If they do, there is no need for a
  569. separating space.
  570.  
  571.         For example:
  572.  
  573.                 .PA
  574.                 .FI  filename
  575.                 .FIfilename
  576.  
  577. .CP30
  578.           Include file                                 .FI filename
  579.           Offset page to right by n columns            .PO n
  580.                                         or             .PO O n
  581.                                         or             .PO E n
  582.           Start new page                               .PA
  583.           If current page number is Odd or Even,       .PB O or E  Text
  584.             print a blank page with Text centred
  585.             on the page.
  586.             eg "This page intentionally left blank"
  587.             Otherwise, start a new page (like .PA)
  588.           Start new page if fewer than n lines remain  .CP n
  589.           Start new page if current page number is
  590.                 Odd or Even                            .CP O or E
  591.           Set page number to n                         .PN n
  592.           Omit page numbers                            .OP
  593.           Print page numbers                           .PG
  594.           Put page number in column n                  .PC n
  595.           Set page length to n lines                   .PL n
  596.           Set top margin to n lines                    .MT n
  597.           Set bottom margin to n lines                 .MB n
  598.           Set header margin to n lines                 .HM n
  599.           Set footer margin to n lines                 .FM n
  600.           Start marking text in margin                 .EV @M1
  601.           Stop Marking text in margin                  .EV @M0
  602.           Define header lines
  603.                 .HE header line 1   }  both the
  604.                 .H1 header line 1   }  same
  605.                 .H2 header line 2
  606.                 .H3 header line 3
  607.           Define footer lines
  608.                 .FO footer line 1   } both the
  609.                 .F1 footer line 1   } same
  610.                 .F2 footer line 2
  611.                 .F3 footer line 3
  612.                    Special Codes within Headers and Footers
  613.                       Insert current page number               #
  614.                       Ignore following spaces on even pages    <CtrlP><CtrlK>
  615.                       Take next character literally            \
  616.                       Invoke printing functions                @
  617. .cp5
  618. .ix   Printing
  619. .ixPrint Formatting;Print Formatting
  620.                         - return the time in format:
  621.                               @T0   HH:MM
  622.                               @T1   HH:MM:SS
  623.                               @T2   HH:MM XX     where XX = AM or PM
  624.                               @T3   HH:MM:SS XX  where XX = AM or PM
  625.                         - return the date in format:
  626.                               @D0  MMM DD, YYYY
  627.                               @D1  DD/MM/YY
  628.                               @D2  DD/MM/YYYY
  629.                               @D3  MM/DD/YY
  630.                               @D4  MM/DD/YYYY
  631.                               @D5  YYYY/MM/DD
  632.                               @D6  DD MMM YYYY
  633.                               @D7  dayname, DD MMM YYYY
  634.                               @D8  DD month YYYY
  635.  
  636.  
  637.  
  638. .tc1 Fig 16.5 - Print Dot Commands Part 1 ..................#
  639.                          Fig 16.5 - Print Dot Commands Part 1
  640. .CP6
  641.                         - return the name of the file being printed
  642.                               @F0  full path name\filename
  643.                               @F1  filename.ext
  644.           Set page number type                         .PT x
  645.                 where x = N or n - numeric (default)
  646.                           R      - Roman Uppercase
  647.                           r      - roman lowercase
  648.                           A      - Alphabetic uppercase
  649.                           a      - alphabetic lowercase
  650.           Line Height (in 1/48th inches)               .LH n
  651.           Line Height (in 1/m inches)                  .LH n/m
  652.           Newspaper Columns                            .CO number , gutter
  653.                                                  or    .CO n,g / width,width
  654.           Column break                                 .CB
  655.           Conditional column break                     .CC n
  656.           Character width                              .CW r.r
  657.           Character width in 1/120 inch                .CW n
  658.  
  659.     Mail Merge and Other Commands
  660.           Define Data file                             .DF filename delim
  661.           Read variables from data file                .RV variable list
  662.           Ask for a variable                           .AV prompt,variable
  663.           Set variable to a value                      .SV variable=value
  664.           Mathematical calculation                     .MA variable=equation
  665.           Display a message                            .DM message
  666.           Go to top of file and start again            .GO
  667.           For Wordstar compatible variable replacement .WS Y or N
  668.           Define Index heading                         .IMtext
  669.           Define Index Entry                           .IXline
  670.                                                        .IXheading;text
  671.           Index refer to line                          .IRtext
  672.                                                     or .IRheading;text
  673.           Width of index line                          .IW width , indent
  674.           Define Table Of Contents Entry               .TCline
  675.                                                     or .TC1 for table 1
  676.                                             through to .TC9 for table 9
  677.           print endnotes at this point                 .PE
  678.           Endnote starting number is set to n          .E#  n
  679.           Footnote starting number is set to n         .F#  n
  680.           Notes style options:                         .NS  xxxx
  681.           IF condition                                 .IF condition
  682.           ELSE                                         .EL
  683.           End IF                                       .EI
  684.  
  685.  
  686.  
  687.                          Fig 16.5 - Print Dot Commands Part 2
  688. .tc1 Fig 16.5 - Print Dot Commands Part 2 ..................#
  689.  
  690.  
  691. The dot commands pertaining to Mail Merge, Tables of Contents &
  692. Indexes are discussed in other chapters. The other commands are
  693. discussed on the following pages.
  694.  
  695. .CP8
  696. .tc        Include File ...................................#
  697.   Include File
  698. .ixInclude File;Include file during printing
  699. .ix   Include file
  700.  
  701. .RR  L     !       !       !       !       !       !       !       !    R
  702.   Files that you print (or generate tables of contents or indexes) can
  703.   include other files, which can in turn include others, up to 5
  704.   levels deep. This is very useful for writing large documents,
  705.   because it permits them to be broken up into separate chapters which
  706.   can be put together at print time.
  707.  
  708. .CP3
  709.   The format of the command is
  710.  
  711.                 .FI filename comment
  712.  
  713. .ixDot Commands;  .FI - Include File
  714.   The file name is mandatory, but the comment is optional. If present,
  715.   it must be separated from the file name by a space. The file will be
  716.   printed in place of the .FI line.
  717.  
  718.   The included file can include others, which may in turn include
  719.   others, up to a maximum of 5 levels. This means that
  720.  
  721.   1    A includes B
  722.   2          which Includes C
  723.   3                      which includes D
  724.   4                              which includes E
  725.   5                                      which includes F
  726.  
  727.   You can have as many file includes in a document as you like. This
  728.   means that you can break your large documents down into chapters,
  729.   tables of contents and indexes, and then break large chapters down
  730.   into smaller parts.
  731.  
  732.   Including Files is also discussed in chapter 8.
  733.  
  734. .CP5
  735. .ix   Printing
  736. .ixPrint Formatting;Print Formatting
  737. .ix   Page Offset
  738. .ixPage Offset;Page Offset
  739. .tc        Page Offset ....................................#
  740.   Page Offset
  741.  
  742.   The printed page can be offset to the right by having a left margin,
  743.   or by specifying a Page Offset. This allows room for binding down
  744.   the left edge.
  745.  
  746. .ixDot Commands;  .PO   - Page Offset
  747. .ixDot Commands;  .PO O - Page Offset Even pages
  748. .ixDot Commands;  .PO E - Page Offset Odd Pages
  749.   The format is
  750.  
  751.                 .PO n                           offset for all pages
  752.                 .PO O n                         offset for Odd pages
  753.                 .PO E n                         offset for Even pages
  754.  
  755.   where n is a number which may be zero. The first format sets the
  756.   same offset for all pages, which the second and third set offsets
  757.   for Odd and Even numbered pages respectively. This later function is
  758.   useful where a document is to be printed on both sides of the page.
  759.  
  760. .tc        Start New Page .................................#
  761.   Start New Page
  762. .ix   Page breaks
  763. .ixPage Breaks;Page Breaks
  764.  
  765.   A page break is a division between two pages. If you have Page
  766.   breaks set ON it's shown on screen as ₧° on the right hand side of
  767.   the screen. It appears on the line that will print on the new page.
  768.  
  769.   A Start New Page command means that all text on the lines that
  770.   follow it will be printed on a subsequent page. Word Fugue will
  771.   automatically break up printing into the amount that will fit on a
  772.   page, but sometimes you may need to over-ride that to ensure that
  773.   for example a table always appears on a single page, or that a
  774.   paragraph does not print separated from its heading, or that the
  775.   first or last line of a paragraph does not appear on a separate
  776.   page.
  777.  
  778. .ixDot Commands;  .PA  - Page break
  779. .ixDot Commands;  .PB E - Page break with blank page if Even page
  780. .ixDot Commands;  .PB O - Page break with blank page if Odd page
  781. .ixDot Commands;  .CP  - Conditional page break
  782. .ixDot Commands;  .CP O - page break if odd page
  783. .ixDot Commands;  .CP E - page break if even page
  784. .CP8
  785.   The format is
  786.  
  787.                 .PA                             start new page
  788.                 .PB O text                      blank next page if Odd
  789.                 .PB E text                      Blank next page if Even
  790.                 .CP n                           new page if less than
  791.                                                 n lines
  792.                 .CP O                           new page if Odd
  793.                 .CP E                           new page if Even
  794.  
  795.   The .PA command always starts a new page. All the other command are
  796.   Conditional page breaks.
  797.  
  798.   The .PB command will always throw a page break, and optionally print
  799.   another page that is blank, depending on whether the page number is
  800.   ODD or EVEN. In addition, if the O or E is followed by text, that
  801.   text will be printed centred in the blank page. The text will not
  802.   be printed unless a blank page is printed.
  803.  
  804.             eg .PB O     THIS PAGE INTENTIONALLY LEFT BLANK
  805.  
  806.   If the current page number is ODD, a blank page will be printed,
  807.   with the text THIS PAGE INTENTIONALLY LEFT BLANK centred on the
  808.   page.
  809.  
  810.   If the page number is even, a page break will be taken.
  811.  
  812. .ix   Printing
  813. .ixPrint Formatting;Print Formatting
  814. .ixConditional;Conditional Page Breaks
  815. .ix   Conditional Page Breaks
  816.   In either case, the next page to have printing will be an odd
  817.   numbered page. (Think about it if this puzzles you).
  818.  
  819.   The converse is true for the .PB E command.
  820.  
  821.   The .CP n command will start a new page if less than n lines remain
  822.   on this page. If more lines remain, the command is ignored.
  823.  
  824.         eg   .CP 5
  825.  
  826.   will start a new page if there are 4 lines remaining on
  827.   the current page. If there are 5 lines remaining, the command will
  828.   be ignored.
  829.  
  830.   The .CP O command will start a new page if the page number is Odd,
  831.   otherwise the command is ignored. The .CP E command will start a new
  832.   page if the page number is Even, otherwise the command is ignored.
  833.  
  834. .tc        Page Numbers ...................................#
  835.   Page Numbers
  836. .ix   Page Numbers
  837. .ixPage Numbers;Page Numbers
  838.  
  839.   Word Fugue keeps track of a document's page numbers during editing
  840.   (if Page Breaks are ON) and during printing (regardless of what Page
  841.   Breaks is set to). The first page of a document is always page
  842.   number one, and subsequent pages are numbered sequentially.
  843.  
  844.   To change the page number that will be printed on a page (and
  845.   subsequent pages), use the .PN dot command.
  846. .ixDot Commands;  .PN - Set page number
  847. .ixPage Numbers;   Set page number (.PN)
  848. .ixPage Numbers;   Changing (.PN)
  849.  
  850.                 eg .PN 15
  851.  
  852.   will set the page number to 15, and subsequent pages will be
  853.   numbered sequentially from 15. Note that if you refer to the page
  854.   number before the line containing the .PN command, the old page
  855.   number will be used, because the new page number does not come into
  856.   effect until the .PN command is processed.
  857.  
  858. .ixDot Commands;  .PG - Print page numbers
  859.   The default for Word Fugue is not to print page numbers unless you
  860.   specify to. This can be done by referring to page numbers in heading
  861.   of footer lines, or by the .PG command. This command tells Word
  862.   Fugue to print the page number at the bottom of the page. (If you
  863.   have not specified a footer or header that refers to page number).
  864.   To print the page number in your own header or footer, use the
  865.   character # at the spot where you want the page number to print. The
  866.   default position for Word fugue to print page numbers automatically
  867.   is column 33.
  868.  
  869. .ixDot Commands;  .PC - page number column for .PG
  870.   The column for automatic page numbers can be changed by the .PC
  871.   command. Type the command followed by the column number you want
  872.   page numbers printed in.
  873.  
  874.         eg .PC 28
  875.  
  876.   will print page numbers in column 28. This only applies to automatic
  877.   page numbers - if you specify a spot for the page number in a footer
  878.   or header, then that spot is used.
  879.  
  880.  
  881. .ix   Printing
  882. .ixPrint Formatting;Print Formatting
  883. .ix   Page Numbers
  884. .ixPage Numbers;Page Numbers
  885. .ixDot Commands;  .OP - omit page numbers
  886.   Automatic page numbering can be turned off again by use of the .OP
  887.   command. This Omits the automatic printing of page numbers until
  888.   turned back on again. This only applies to automatic page numbers -
  889.   if you specify page numbering in a footer or header, then page
  890.   numbers will continue to print.
  891.  
  892. .ixDot Commands;  .PT - Page number Type
  893. .ix   Page Number Style (.PT)
  894. .ixPage Numbers;   Page Number Style (.PT)
  895.   The style of page number can be set to be other than numbers by use
  896.   of the .PT command. The internal page number is converted into the
  897.   specified format.
  898.  
  899.           eg .PT x
  900.                 where x = N or n - numeric (default)
  901.                           R      - Roman Uppercase
  902.                           r      - roman lowercase
  903.                           A      - Alphabetic uppercase
  904.                           a      - alphabetic lowercase
  905.  
  906.              .PT r
  907.  
  908.   will print page numbers as lowercase roman letters. IE page number 3
  909.   will print as iii, while
  910.  
  911.             .PT A
  912.  
  913.   will print page number 3 as C.
  914.  
  915. .ixPage Numbers;   Page Number Style .PT
  916.   This is useful for special numbering of tables of contents,
  917.   appendices or indexes.
  918.  
  919.  
  920. .tc        Vertical Print Margins .........................#
  921.   Vertical Print Margins
  922. .ix   Vertical Print Margins
  923.  
  924. .tc           Page Length .................................#
  925.   Page Length
  926. .ix   Page Length
  927. .ixDot Commands;  .PL - Page Length
  928.  
  929.   Page length is the total number of lines on a page. At the default
  930.   of 6 lines per inch, a standard 11 inch page (USA Standard) has 66
  931.   lines, which is the Word Fugue default page length. A standard A4
  932.   page (European Standard) is 11 2/3 lines long, and fits 70 lines per
  933.   page.
  934.  
  935. .CP5
  936.   The number of lines that actually print is determined by the page
  937.   length in combination with the top and bottom margins. With all the
  938.   defaults - 66 lines per page, top margin 5 lines and bottom margin 4
  939.   lines, the actual number of lines in the text body of the page is
  940.   66 - 5 - 4 = 57 lines, not including the headers and footers.
  941.  
  942.   The default lines per page can be changed from the Margins sub menu
  943.   of the Options menu, and can be set to any positive value. This
  944.   value can be over-ridden by the .PL dot command. For example .PL 84
  945.   gives a page length of 84 lines, the number on a legal size
  946.   (14-inch) page. This command also sends a command to the printer to
  947.   tell it what the new page length is - stored in the "Page length in
  948.   Lines" slot in the Printer Definition file.
  949.  
  950. .ixDot Commands;  .PL - Page Length
  951.   .PL will send a sequence to the printer as follows:
  952.  
  953.       If the page length entry is not empty, the sequence will be
  954.       sent. Otherwise nothing will be sent.
  955.  
  956.       If the sequence includes a '#', it will be replaced by the
  957.       decimal equivalent of the number following the .PL command. Thus
  958.       .PL 70 with a sequence of <esc>C# would send <esc>CF to the
  959.       printer. F is the printable equivalent of decimal 070. If the
  960.       number is bigger than one character, the low byte comes first
  961.       thus <esc>Cmn where the number = m + 256*n.
  962.  
  963.       If the sequence includes a '$' sign, it will be replaced by the
  964.       character representation of the number itself. Thus .PL70 with a
  965.       sequence of |PL$. would send |PL70. to the printer.
  966.  
  967. .cp6
  968. .ix   Printing
  969. .ixPrint Formatting;Print Formatting
  970. .tc           Line Height .................................#
  971.   Line Height
  972.  
  973. .ixDot Commands;  .LH - Line Height
  974. .ix   Line Height
  975.   Changing the top or bottom margin alters the number of lines of text
  976.   that can be printed on a page, as does changing the number of lines
  977.   per inch. Smaller margins and more lines per inch mean more lines
  978.   that can be printed on a page.
  979.  
  980.   The lines per inch is set by the .LH command. (Alternatively, you
  981.   can set up an unused print command to set a special lines per inch
  982.   command). The format is
  983.  
  984.         .LH n                    line height in n/48ths of an inch
  985.         .LH n/m                  line height in n/mths of an inch
  986.  
  987.   For example .LH 16 gives 3 lines per inch, since the line height is
  988.   16/48ths of an inch. This will print a document double spaced. The
  989.   /m is optional, but is used if your printer uses a different
  990.   stepping than the default 48th inch. This is necessary for Word
  991.   Fugue to calculate the correct number of lines that will fit on the
  992.   page. Word Fugue sends the sequence found in the "Line Height" slot
  993.   of the Printer Definition File followed by the value of n in exactly
  994.   the same manner that the .PL command does. That means that you
  995.   should have either a # character or a $ character included in the
  996.   sequence, and it will be replaced by a number.
  997.  
  998. .cp21
  999. .ix   Printing
  1000. .ixPrint Formatting;Print Formatting
  1001. .ixDot Commands;  .LH - Line Height
  1002. .ix   Line Height
  1003.   The chart below (fig 16.6) shows how different settings for the .LH
  1004.   command affect the number of lines per inch in the printout.
  1005.  
  1006.  
  1007.                   Command         Lines/inch
  1008.  
  1009.                   .LH 5           9.6
  1010.                   .LH 6           8
  1011.                   .LH 7           6.8
  1012.                   .LH 8           6
  1013.                   .LH 12/72       6 (in 72nds of an inch)
  1014.                   .LH 6/72        12
  1015.                   .LH 27/216      8
  1016.                   .LH 12          4   (one & a half spacing)
  1017. .ixDouble;Double Spaced Text (.LH)
  1018.                   .LH 16          3   (Double spaced text)
  1019.                   .LH 24          2   (Triple line spacing)
  1020.  
  1021.  
  1022.    Fig 16.6 - Sample Line Heights and Equivalent Lines per Inch
  1023. .tc1 Fig 16.6 - Line Heights and Equivalent Lines per Inch .#
  1024.  
  1025.  
  1026. .tc           Line Width ..................................#
  1027.   Line Width
  1028.  
  1029. .ixDot Commands;  .LW - Line Width
  1030.   You can also change the width of the line by the use of dot
  1031.   commands. the .LW command sets the width in characters. For example
  1032.   .LW 120 tells Word Fugue that the line width from now on is 120
  1033.   characters. It also sends the print sequence in the "Line width"
  1034.   slot in the printer definition file to the printer, followed by the
  1035.   decimal value of the number that followed the line width command, in
  1036.   exactly the same manner as the .PL command does.
  1037.  
  1038. .tc           Margins .....................................#
  1039.   Margins
  1040.  
  1041. .CP5
  1042.   The top and bottom margins affect printing by changing where the
  1043.   page breaks go. They do not show on the screen. To find out how many
  1044.   lines will print on a page, subtract the top and bottom margins from
  1045.   the page length. For example 66 lines minus 5 top margin minus 4
  1046.   bottom margin gives 57 lines of text.
  1047.  
  1048. .ixDot Commands;  .MT - Margin at Top
  1049. .ixDot Commands;  .MB - Margin at Bottom
  1050. .ix   Margins
  1051. .ix   .MT - Margin at Top
  1052. .ix   .MB - Margin at Bottom
  1053. .ixMargins         ;   Top margin (.MT)
  1054. .ixMargins         ;   Bottom margin (.MB)
  1055.   To change the Top margin, use the .MT dot command, and follow it by
  1056.   the number of lines in the margin. For example .MT 4 sets the top
  1057.   margin to 4 lines. The bottom margin is set by the .MB command in
  1058.   the same fashion.
  1059.  
  1060. .CP5
  1061.   Headers and Footers also have margins. The header margin is the
  1062.   number of blank lines between the top of the page and the first
  1063.   heading line. The footer margin is the number of lines between the
  1064.   bottom of the page and the last footer line.
  1065.  
  1066. .ixDot Commands;  .HM - Header Margin
  1067. .ixDot Commands;  .FM - Footer Margin
  1068. .IX   Header margin (.HM)
  1069. .ix   Footer Margin (.FM)
  1070. .ix   .HM - Header Margin
  1071. .ix   .FM - Footer Margin
  1072. .ixHM;.HM - Header Margin
  1073. .ixFM;.FM - Footer Margin
  1074. .ixMargins         ;   Header (.HM)
  1075. .ixMargins         ;   Footer (.FM)
  1076.   The header margin is set by the .HM command, while the footer
  1077.   margin is set by the .FM command. In each case follow the command by
  1078.   the number of lines in the margin. Refer to fig 16.7 below for more
  1079.   information about the relationship between the margins and the page.
  1080.  
  1081.  
  1082. .cp25
  1083. .ix   Printing
  1084. .ixPrint Formatting;Print Formatting
  1085.  
  1086.            ┌─────>   ╔════╤═══════════════════╤══════╗
  1087.            │         ║    │                   ├──────║─ .MT
  1088.            │     .HM─║────┤                   │      ║
  1089.            │         ║    Header line         │      ║
  1090.            │         ║    ┌───────────────────┴┐     ║
  1091.            │         ║    │adfhd sdf sdf sdf df│     ║
  1092.            │         ║    │df asdf sdf sdf fff │     ║
  1093.            │         ║    │asdfdf asdf sad sdff│     ║
  1094.            │         ║    │asdf asdf sdf asdffd│     ║
  1095.            │         ║    │asdfas┌──────┐f sadf│     ║
  1096.       .PL ─┤         ║    │asdf a│ TEXT │sdfsdf│     ║
  1097.            │         ║    │asdf a└──────┘sddfa │     ║
  1098.            │         ║    │asdf asdfasdf ass sd│     ║
  1099.            │         ║    │asdf asdfa asdf assf│     ║
  1100.            │         ║    │asdf asdf asdf asdf │     ║
  1101.            │         ║    └────────────────────┘     ║
  1102.            │         ║    Footer line         │      ║
  1103.            │         ║    │                   ├──────║─ .MB
  1104.            │     .FM─║────┤                   │      ║
  1105.            └─────>   ╚════╧═══════════════════╧══════╝
  1106.  
  1107.  
  1108.            Fig 16.7 - Diagram of Vertical Print Margins
  1109. .tc1 Fig 16.7 - Diagram of Vertical Print Margins ..........#
  1110.  
  1111.  
  1112.         ■ MT must be greater than HM for the header to print
  1113.         ■ MB must be greater than FM for the footer to print
  1114.         ■ PL must be greater that MT + MB
  1115.         ■ if MT = 0 or MB = 0 then no pagination occurs.
  1116.         ■ Default page numbers do not appear if FO or F1 is used.
  1117.  
  1118.  
  1119. .CP5
  1120. .tc        Headings and Footers ...........................#
  1121.   Headings and Footers
  1122.  
  1123.   A footing (or footer) is special text that prints at the bottom of
  1124.   every page. A heading (or header) is special text that prints at the
  1125.   top of every page. You can define up to 3 lines of heading and 3
  1126.   lines of footers for your text. You can use different headings in
  1127.   different parts of your file, and you can turn them off.
  1128.  
  1129.   To define heading and footers, use the commands below in your text.
  1130. .ixDot Commands;  .HE - Heading
  1131. .ixDot Commands;  .H1 - Heading line 1
  1132. .ixDot Commands;  .H2 - Heading line 2
  1133. .ixDot Commands;  .H3 - Heading line 3
  1134. .ixDot Commands;  .FO - Footer
  1135. .ixDot Commands;  .F1 - Footer line 1
  1136. .ixDot Commands;  .F2 - Footer line 2
  1137. .ixDot Commands;  .F3 - Footer line 3
  1138. .ix   .HE - Heading
  1139. .ix   .H1 - Heading line 1
  1140. .ix   .H2 - Heading line 2
  1141. .ix   .H3 - Heading line 3
  1142. .ix   .FO - Footer
  1143. .ix   .F1 - Footer line 1
  1144. .ix   .F2 - Footer line 2
  1145. .ix   .F3 - Footer line 3
  1146. .ixHeaders;   Dot commands for (.HE,.H1,.H2,.H3)
  1147. .ixFooters;   Dot commands for (.FO,.F1,.F2,.F3)
  1148. .ixHeaders;   Defining
  1149. .ixFooters;   Defining
  1150.  
  1151. .CP5
  1152.                 .HE or .H1      header line 1
  1153.                 .H2             header line 2
  1154.                 .H3             header line 3
  1155.                 .FO or .F1      footer line 1
  1156.                 .F2             footer line 2
  1157.                 .F3             footer line 3
  1158.  
  1159.  
  1160.   To turn a footer or header off, type the dot command with no text
  1161.   following. It will print as blank. To put a blank line between two
  1162.   headings or footers, type .F1 (or .H1) and the text for the first
  1163.   line. For the blank line, type .F2 ( or .H2) and the Enter key. For
  1164.   the third line, type .F3 (or .H3) and the text for the last line.
  1165.  
  1166.  
  1167.  
  1168.                       Insert current page number               #
  1169.                       Ignore following spaces on even pages    <CtrlP><CtrlK>
  1170.                       Take next character literally            \
  1171.                       Invoke printing functions                @
  1172.  
  1173.  
  1174.          Fig 16.8 - Special Codes within Headers and Footers
  1175. .tc1 Fig 16.8 - Special Codes within Headers and Footers ...#
  1176. .ix   Printing
  1177. .ixPrint Formatting;Print Formatting
  1178. .ix   Headers & Footers
  1179. .ix   Footers & Headers
  1180.  
  1181.  
  1182. .ixHeaders;   Page numbers in
  1183. .ixFooters;   Page numbers in
  1184.   To include the page number in a header or footer, use the #
  1185.   character. For example .FO page # prints as Page 1 on the first
  1186.   page. To print the # character itself, use the | character. For
  1187.   example .HE Draft |#2 prints as Draft #2. To print a | in a header
  1188.   or footer, use two bars together (||).
  1189.  
  1190. .ixHeaders;   Print controls in
  1191. .ixFooters;   Print controls in
  1192.   You can use print controls such as Ctrl P B (bolding) or Ctrl P S
  1193.   (underlining) in footers and headings. These print features will
  1194.   print independently of whatever print features are active in the
  1195.   text body - Word Fugue turns off all active print features before
  1196.   printing a heading or footer, and then turns them back on again.
  1197.  
  1198. .ixHeaders;   Alternating left & right (^P^K)
  1199. .ixFooters;   Alternating left & right (^P^K)
  1200.   To produce alternating left and right footers and headings, use the
  1201.   Ctrl P K command on the footer and heading lines. Press Ctrl P K
  1202.   and then use the Spacebar to space over to where you want the text
  1203.   to start on the right hand (odd numbered) page. Then type the
  1204.   heading or footer text. The spaces following the Ctrl PK up to the
  1205.   text will print on odd numbered pages, but not on even numbered
  1206.   pages. Any spaces before the Ctrl P K will print on both pages.
  1207.  
  1208.   On the printed page, the character immediately following the dot
  1209.   command is the first character of the heading or footer, and will
  1210.   print in column one. If you want the heading or footer to commence
  1211.   in column one, type the text immediately after the dot command with
  1212.   no intervening spaces (.F1text).
  1213.  
  1214. .CP5
  1215.   Additional print functions (see below for a discussion of print
  1216.   functions) can be invoked in a heading or footer line. Print
  1217.   functions start with an @ character. Thus to print an @ character in
  1218.   your heading or footer, you must prefix it with a vertical bar (|@).
  1219.  
  1220.   The heading and footer print within the top or bottom margin, they
  1221.   do not count as lines of text. See Fig 16.2 above.
  1222.  
  1223. .cp15
  1224. .tc        Print Functions ................................#
  1225. .ix   Printing
  1226. .ixPrint Formatting;Print Formatting
  1227. .ix   Print Functions
  1228.   Print Functions
  1229.  
  1230.   Print functions feature an @ character followed 1, 2 or 3
  1231.   characters. In headers or footers, simply insert the print function
  1232.   where you want it to print.
  1233.  
  1234.   In the text body, you must enclose the print functions in special
  1235.   brackets:
  1236.  
  1237.          {. to start interpretation
  1238.      and }  to stop interpretation.
  1239.  
  1240.         - return the time in format:
  1241.  
  1242.           @T0   HH:MM        military - 24 hour clock
  1243.           @T1   HH:MM:SS       "            "
  1244.           @T2   HH:MM XX     where XX = AM or PM (12 hour clock)
  1245.           @T3   HH:MM:SS XX  where XX = AM or PM  "   "    "
  1246.  
  1247.         - return the date in format:
  1248.  
  1249.           @D0  MMM DD, YYYY
  1250.           @D1  DD/MM/YY
  1251.           @D2  DD/MM/YYYY
  1252.           @D3  MM/DD/YY
  1253.           @D4  MM/DD/YYYY
  1254.           @D5  YYYY/MM/DD
  1255.           @D6  DD MMM YYYY
  1256.           @D7  dayname, DD MMM YYYY
  1257.           @D8  DD month YYYY
  1258.  
  1259.         - return the name of the file being printed
  1260.  
  1261.           @F0  full path name\filename
  1262.           @F1  filename.ext
  1263.  
  1264.         - return appropriately formatted level number
  1265.  
  1266.           @L1 to @L9 - refer to chapter 14 for more information on
  1267.           printing level numbers.
  1268.  
  1269. .CP10
  1270. .tc        Mark Changes in Left Margin ....................#
  1271.   Mark Changes in Left Margin
  1272.  
  1273. .ev @M1
  1274.   Changes are marked in the left margin with a | symbol. This is
  1275.   useful if you have a manual that is revised from time to time - it
  1276.   is customary to issue revised pages with markings in the left margin
  1277.   indicating new text, as this paragraph shows.
  1278. .ev @m0
  1279.  
  1280. .ixDot Commands;  .EV - evaluate print functions
  1281.           Start marking text in margin                 .EV @M1
  1282.           Stop Marking text in margin                  .EV @M0
  1283.  
  1284.   These commands are also print functions and can be included in the
  1285.   text body as such. In this case they will take effect from the line
  1286.   following the line they are in.
  1287.  
  1288. .RRL !     !       !       !       !       !       !       !       !    R
  1289. .CP6
  1290. .tc    Selecting Printer Definition Files .................#
  1291. Selecting Printer Definition Files
  1292.  
  1293. The definition of control sequences for a given printer are stored in
  1294. a file with the name set to something similar to the printer, and the
  1295. extension set to .PDF. Editing those sequences has been covered above.
  1296.  
  1297. Most of those files apply to physical printers. If you do not see your
  1298. printer name among the list, then it will emulate one of those in the
  1299. list. You should consult your printer manual to determine what
  1300. printers it emulates.
  1301.  
  1302. The most common ones are:
  1303.  
  1304.        Epson
  1305.        IBM Proprinter
  1306.        HP Laserjet
  1307.  
  1308. If your printer does not appear to be supported, contact Fugue
  1309. Software or your local distributor to see which PDF should be used. In
  1310. the unlikely event that your printer is not supported, Fugue Software
  1311. will configure a printer driver for you, providing you are prepared to
  1312. send us either your printer manual (we will return it) or a photocopy
  1313. of the section that specifies the printer control sequences. The
  1314. driver will be supplied free of charge.
  1315.  
  1316. .tc    Special Printer Definition Files ...................#
  1317. Special Printer Definition Files
  1318.  
  1319. In addition to the normal PDFs, (ie those applying to physical
  1320. printers) there are 2 others for special purposes.
  1321.  
  1322. .tc       Print Preview ...................................#
  1323.   Print Preview
  1324.  
  1325.   You can obtain a preview of your print by selecting PREVIEW.PDF as
  1326.   the printer definition file, and by changing the device to File. You
  1327.   will be prompted for the file name. When you request printing to
  1328.   start, the printed output will be written to the file you specified.
  1329.  
  1330.   When printing finishes, you can load this file into Word Fugue to
  1331.   see how the printed output will look. The various fonts will show
  1332.   on screen as they would normally, in different colours or shades of
  1333.   grey (depending on your monitor and card). The headers and footers
  1334.   will appear at the start and end of the pages, snaking columns will
  1335.   appear side by side, and so on.
  1336.  
  1337. .tc       Quick Link Fax ..................................#
  1338.   Quick Link Fax
  1339.  
  1340.   If you use a fax card that comes with Quick Link 2 FaxTM software from
  1341.   Smith Micro Software Inc, then you can use a similar technique for
  1342.   producing a .CAP file for input to the fax process.
  1343.  
  1344.   The PDF to choose is QL2FAX.PDF, which includes standard Epson codes
  1345.   that the fax software will recognise. It also included the
  1346.   appropriate information to permit QL2FAX to recognise the file as a
  1347.   CAP file.
  1348.  
  1349. .CP5
  1350.   Select Device and set it to file. When you are prompted for a file
  1351.   name, choose one that does not currently exist. You should set the
  1352.   extension to .CAP
  1353.  
  1354.   If you plan to use the QL2FAX  .FILE= command, then you must take
  1355.   precautions to prevent Word Fugue from attempting to interpret this
  1356.   command as a .FI command, and thus not writing it to the output
  1357.   file. You should either
  1358.  
  1359.     - change the dot command prefix to something else like @, and
  1360.       prefix all your dot commands with this character instead of a
  1361.       dot so that .PA becomes @PA, and .FI becomes @FI. In this case,
  1362.       all print functions embedded in the text in {. } must be changed
  1363.       so that the they are embedded in {@ } instead.
  1364.  
  1365.   or
  1366.  
  1367.     - indent the .FILE= command in at say character position 2, which
  1368.       will prevent Word Fugue from recognising the .FILE= as a .FI
  1369.       command. The .FILE= command should be the only thing on the
  1370.       line, or QL2FAX will not properly recognise it as a file merge
  1371.       command. In this case, be careful if you have text on the line
  1372.       above or below the .FILE= command, since any paragraph
  1373.       formatting will draw that command into the text above or below,
  1374.       and prevent QL2FAX from properly recognising the command.
  1375. {.╬}
  1376. .tc       Ascii Print .....................................#
  1377.   Ascii Print
  1378.  
  1379.   You can obtain a disk file corresponding to an Ascii print of you
  1380.   document (ie without any special fonts or printer control sequences)
  1381.   by printing to a file and selecting ASCII.PDF  This will give you
  1382.   all the headers and footers in the right places, which is different
  1383.   from the Export Ascii command. This is useful if you wish to issue a
  1384.   disk version of documentation.
  1385.